home *** CD-ROM | disk | FTP | other *** search
/ Network CD 2 / Network CD - Volume 2.iso / programs / internet / tcp / mail / inet1_3tcp.lha / INetUtils-1.3-AmiTCP / man / SMTPpost.man < prev   
Encoding:
Text File  |  1994-02-12  |  5.3 KB  |  160 lines
  1. SMTPpost                                SMTPpost
  2.  
  3.  
  4. NAME
  5.  
  6.     SMTPpost - post a mail message using SMTP
  7.  
  8.  
  9. SYNOPSIS
  10.  
  11.     SMTPpost [-f fromuser] [-R userrealname] [-s subject] [-r]
  12.          [-Q] [-S]
  13.          [-raw] [-n] [-t to-addr] [-c cc-addr] [-b bcc-addr]
  14.          [mailfile | addresses] <mailfile
  15.  
  16.  
  17. DESCRIPTION
  18.  
  19.     SMTPpost uses SMTP (per RFC-821) to post 'mailfile' to the
  20.     addresses specified via the -t, -c and -b arguments. If none
  21.     of -t, -c or -b are specified, the destination addresses are
  22.     obtained from the headers in 'mailfile'.
  23.  
  24.     Whenever an address is required, a comma-separated set of
  25.     addresses may be applied. If they are for the -t, -c or -b
  26.     arguments, there may be *no* white-space in between the
  27.     addresses.
  28.  
  29.     SMTPpost will attempt to open a TCP SMTP socket to each
  30.     destination host. If that fails, SMTPpost will attempt to
  31.     forward the mail to the SMTPSmarterHost (which is specified
  32.     via a required configuration variable). If a socket cannot
  33.     be opened, then SMTPpost will store the article in the
  34.     SMTPSpoolDir (which is also specified via another required
  35.     configuration variable) for processing later by SMTPd.
  36.  
  37.     The -Q argument tells SMTPpost to *not* try to send the
  38.     message immediately. Instead, the article is queued into
  39.     SMTPSpoolDir and SMTPd is expected to process the actual
  40.     transmission of the message.
  41.  
  42.     The -S argument tells SMTPpost to *not* try to access the
  43.     destination host at all. All messages will go directly to
  44.     SMTPSmarterHost (or be queued if it isn't available or if
  45.     the -Q argument is specified).
  46.  
  47.     For the cases where the destination address is the local
  48.     host, SMTPpost also requires the SMTPMailDir configuration
  49.     variable to be assigned, denoting the appropriate directory.
  50.  
  51.     If the delivery succeeds, SMTPpost will log that in the
  52.     INetUtils logfile (INet:Logfile) and return a program value
  53.     of zero.
  54.  
  55.     If the delivery fails, SMTPpost will log that as well, along
  56.     with a description failure reason. SMTPpost will return a
  57.     program value of thirty (30) in that case.
  58.  
  59.     "mailfile" may be specified on the command line, or as the
  60.     standard input.
  61.  
  62.     If SMTPpost's program name starts with an 'r' (such as 'rsmtp')
  63.     then SMTPpost assumes that all command line arguments are
  64.     addresses that the mailfile (which *must* be on standard input)
  65.     are to be delivered to. "mailfile" must be fully formed and
  66.     complete. SMTPpost will not add a "Subject:", "From:" or an
  67.     "Organization:" header in this case. This is called "receive
  68.     mail" mode.
  69.  
  70.     Options:
  71.  
  72.         -b addrs    : Specify an address to which a message is
  73.               be sent (the Blind Carbon Copy header).
  74.               The -b argument may be repeated any
  75.               number of times. No BCC recipient is
  76.               aware of any other BCC recipient.
  77.  
  78.         -c addrs    : Specify an address which is to be added
  79.               to the Carbon-Copy list (the CC: headers).
  80.               The -c argument may be repeated any number
  81.               of times.
  82.  
  83.         -f username : The username to be used in building a From
  84.               header in the article. Note that if a From
  85.               header already exists in the article, then
  86.               SMTPpost will not create another one.
  87.  
  88.         -n        : Do not queue. If the delivery to either the
  89.               destination host and to SMTPSmarterHost
  90.               fails, SMTPpost will normally queue the
  91.               article in SMTPSpoolDir. Setting this
  92.               option prevents that from happening (this
  93.               is intended primarily for SMTPd).
  94.  
  95.         -Q        : Queue the message, do not send immediately.
  96.  
  97.         -S        : Do not attempt a connection to the destination
  98.               host, route the message to SMTPSmarterHost.
  99.  
  100.         -r        : Receive mail mode. All arguments after -r
  101.               are treated as addresses that mailfile (which
  102.               *must* be in standard input) is to be
  103.               delivered to. See discussion above.
  104.  
  105.         -raw    : Normally, if all of -f, -R and -s are not
  106.               specified, SMTPpost will scan "mailfile"
  107.               to obtain the missing headers. This option
  108.               prevents that from occurring. Empty headers
  109.               are created instead.
  110.  
  111.         -R realname : The real name of the user to be used in
  112.               building a From header for the message.
  113.  
  114.         -s text    : The subject of the message. "text" may
  115.               be quoted (and in fact, must be if there
  116.               is any whitespace in it).
  117.  
  118.         -t addrs    : Specify a destination address for the message.
  119.               This one is for the To: header. The -t
  120.               argument may be repeated any number of times.
  121.  
  122. DIAGNOSTICS
  123.  
  124.     Upon success, SMTPpost has a return status of zero.
  125.  
  126.     If the destination host was not available, and SMTPpost queued
  127.     the message (or left it queued, when called from SMTPd); then
  128.     SMTPpost has a return status of 5.
  129.  
  130.     Upon failure of any kind, SMTPpost prints a message to standard
  131.     output, and has an exit status of 30. SMTPpost also prints the
  132.     error message in INet:Logfile.
  133.  
  134.  
  135. NOTES
  136.  
  137.     SMTPpost duplicates the arguments used by the AmigaUUCP sendmail.
  138.     It can be dropped-in as a replacement for that.
  139.  
  140.     SMTPpost has been tested with AmigaUUCP, GRn, and BBX.
  141.  
  142.     If SMTPpost must generate a From header, it requires that USERNAME,
  143.     HOSTNAME (or NODENAME) and DOMAINNAME be defined either as environment
  144.     variables, or in UULib:Config.
  145.  
  146.     SMTPpost will attempt to run a command named by the MAILREADYCMD
  147.     environment variable when delivering local mail. The format of the
  148.     command is:
  149.  
  150.         MAILREADYCMD -x T:MailRdy
  151.  
  152.     SMTPpost will also send a signal to a public message port named
  153.     "T:MailRdy" if it is on the system public list.
  154.  
  155. BUGS/TODO
  156.  
  157.     SMTPpost doesn't accept full RFC-822 addresses.
  158.  
  159.     The alias implementation is severely broken.
  160.